home *** CD-ROM | disk | FTP | other *** search
/ User's Choice Windows CD / User's Choice Windows CD (CMS Software)(1993).iso / utility1 / drwats75.zip / DRWATSON.TXT < prev    next >
Text File  |  1991-07-29  |  8KB  |  203 lines
  1. DrWatson.TXT
  2.  
  3. This document contains information on:
  4.  
  5.    A. What is DrWatson?
  6.    B. How to install DrWatson
  7.    C. Using DrWatson
  8.    D. Where to send information gathered by DrWatson
  9.    E. Additional details on DrWatson
  10.  
  11.  
  12. A. What is DrWatson?
  13. --------------------
  14. DrWatson is a diagnostic tool designed to provide developers 
  15. with detailed information on the internal state of Windows 
  16. when a system error such as an unrecoverable application 
  17. error (UAE) occurs.  
  18.  
  19. DrWatson must be running at the time a UAE occurs in order 
  20. to extract the required internal information from the system.
  21. DrWatson takes very little memory and does not affect 
  22. performance, so we encourage you to install DrWatson if a UAE 
  23. has occurred before.  
  24.  
  25. After DrWatson is installed, if another UAE occurs, valuable 
  26. information will be collected and written to a special file 
  27. in the WINDOWS directory.  Microsoft can use this information 
  28. to make the next version of Windows even better than 
  29. Windows 3.0.  Application vendors can also use this 
  30. information to improve their applications.
  31.  
  32.  
  33. B. How to install DrWatson
  34. --------------------------
  35. DrWatson must be running at the time the system error occurs 
  36. in order to collect the internal information from the system, 
  37. so we recommend DrWatson be started automatically each time 
  38. you start Windows.  
  39.  
  40. To start DrWatson automatically when you start Windows, do 
  41. the following:
  42.  
  43. 1) Copy DrWatson.EXE and toolhelp.DLL to the directory in 
  44.    which Windows is installed.
  45.  
  46. 2) Open the WIN.INI file by using a text editor, such 
  47.    as NOTEPAD.
  48.  
  49. 3) Add DrWatson to the LOAD= or RUN= line.  You will find 
  50.    these lines located at the beginning of the WIN.INI file.
  51.  
  52. 4) Save the WIN.INI file.
  53.  
  54. 5) Restart Windows if you edited the WIN.INI file while 
  55.    you were running Windows.
  56.  
  57. Alternatively, you can start DrWatson as you would start 
  58. any other Windows application, by using the Program Manager 
  59. or File Manager.  
  60.  
  61. Once started, DrWatson appears as an icon on your desktop.
  62.  
  63.  
  64. C. Using DrWatson
  65. -----------------
  66. While DrWatson is running, if a UAE occurs, DrWatson will
  67. automatically create a special file in your WINDOWS directory
  68. named DrWatson.LOG. It will also prompt you for details regarding the
  69. circumstances of how the UAE occured.  Please include enough
  70. information to help our developers track the problem down.  Each time
  71. a UAE occurs, DrWatson appends new data to this file.
  72.  
  73. The DrWatson.LOG file will contain a large amount of data, most of
  74. which is not useful unless you are a developer and are familiar with
  75. debugging applications.  This file is a standard text file so it can
  76. be viewed with a text editor if you wish to look at it.
  77.  
  78. At this time, DrWatson does not detect all system errors, 
  79. so don't be alarmed if DrWatson did not record information 
  80. after a particular system error.
  81.  
  82. D. Where to send information gathered by DrWatson
  83. -------------------------------------------------
  84. The Microsoft Windows development team wants to gather as 
  85. much DrWatson data as possible.  The data will be used to 
  86. identify and correct problems in both Windows and Windows 
  87. applications. There are a number of ways to send this data 
  88. to us. (We prefer to receive this data in electronic form 
  89. since that's easier to process.)  In all cases, please 
  90. include the name and phone number of a person we can contact 
  91. in the event we need additional data.
  92.  
  93.  
  94. - Send a disk with the DrWatson.LOG file on it to Microsoft.  
  95.   The mailing address is:
  96.                                Microsoft Corporation.
  97.                    Attn:  WINDOWS BETA PROGRAM 3/2
  98.                                One Microsoft Way
  99.                                Redmond, WA 98052-6399
  100.  
  101. - Post the data contained in DrWatson.LOG in the "Problem 
  102.   Reports" forum in the Microsoft Windows section on 
  103.   Compuserve. There's an online form there to use for 
  104.   your convenience.  This form can only be used if you are
  105.   using a Windows based product to connect to CompuServe. 
  106.  
  107. - Print DrWatson.LOG, then FAX it to Microsoft.  Mark it 
  108.   "Attn WINDOWS BETA PROGRAM 3/2".  The Microsoft FAX number is
  109.   (206) 883-8101.
  110.  
  111. - Print DrWatson.LOG, then sent it Microsoft, mark "Attn 
  112.   WINDOWS BETA PROGRAM". The mailing address is listed above.
  113.  
  114.  
  115. E. Additional Technical Details on DrWatson
  116. --------------------------------------------
  117. This section describes some technical details about 
  118. DrWatson, including the form of the DrWatson report and 
  119. the various options that can be turned on and off.  This 
  120. section is probably not of interest to most users, but 
  121. may be valuable to developers.
  122.  
  123. Changing the Log File
  124.    By default, the log file report is called "DrWatson.LOG".
  125.    You can change the name and location of this file by adding 
  126.    a "logfile=" entry to the [DrWatson] section of WIN.INI.  
  127.    You can also redirect output to a serial or parallel device.  
  128.    For example, to send reports to a debugging terminal, add 
  129.    this line:
  130.  
  131.    [DrWatson]
  132.    logfile=com1
  133.  
  134. Report Format
  135.    Each section of a DrWatson report can be disabled by adding 
  136.    it to the "skipinfo=" entry of the [DrWatson] section of 
  137.    WIN.INI.  For example, to disable the module list output of 
  138.    a report, add this line:
  139.  
  140.    [DrWatson]
  141.    skipinfo=module
  142.  
  143. DrWatson Report Header
  144.    The first section of the report indicates the DrWatson 
  145.    software version (0.72), time and date of event, the fault 
  146.    type ('Invalid  Opcode'), selector:offset of the fault, and 
  147.    segment number and file name of the current application.
  148.  
  149.    For example:
  150.    
  151.    Dr. Watson 0.73 Failure Report - Fri May 17 14:11:29 1991
  152.    MEM had a 'Exceed Segment Bounds (Read)' fault at MEM 1:1157
  153.    $tag$   MEM     Exceed Segment Bounds (Read)    MEM 1:1157\
  154.          repne   scasb   Fri May 17 14:11:29 1991
  155.    
  156.    This part of the report is mandatory; it cannot be disabled.
  157.  
  158. CPU Registers
  159.    The 16 bit CPU registers, segment registers linear base 
  160.    address and limit, whether the selectors are Code, Data, or 
  161.    NULL.  This section is important, but you can disable it by 
  162.    adding "skipinfo=regs" to the [DrWatson] section of WIN.INI.
  163.  
  164. 32 Bit CPU Registers
  165.    If the CPU is a 386 or 486, the 32 bit register contents 
  166.    will be displayed, unless "skipinfo=32bit" is added to WIN.INI.
  167.  
  168. Disassembly
  169.    The instructions before and after the faulting instruction 
  170.    are disassembled.  This section can be disabled with 
  171.    "skipinfo=disasm".  The faulting instruction is marked with 
  172.    the (module name:symbol+offset) of that address.  This last 
  173.    feature requires the presence of a .SYM file with debugging 
  174.    symbols in the same directory as the associated .EXE file.
  175.  
  176. Stack Dump/Trace
  177.    The stack dump shows stack frames, letting you know the 
  178.    calling sequence that produced the fault.   This section 
  179.    can be disabled with the line "skipinfo=stack".
  180.  
  181. Task List
  182.    System tasks are all active applications.  Disable with 
  183.    "skipinfo=tasks".
  184.  
  185. Module List
  186.    The module list is very large, and probably not vital.  
  187.    We recommend disabling it with "skipinfo=modules".
  188.    It is sometimes useful to deduce the version of a driver
  189.    or application by looking at the time/date/size of the 
  190.    file.
  191.  
  192. System Info
  193.    System info is miscellaneous information available.  
  194.    Disable it with "skipinfo=info".
  195.  
  196. Other Reports
  197.    At this point, DrWatson's GP Fault decoding logic is 
  198.    incomplete.  We detect many possible GP faults, but 
  199.    not all.  Examples we detect are null pointer usage, 
  200.    writing to code segments, segment limit violations. 
  201.    Other faults may occur that display as "Unknown".  Let
  202.    us know if that is a problem for you.
  203.